ETSITS126 273V11.0.0 



(2012-10) 




Digital cellular telecommunications system (Phase 2+); 
Universal Mobile Telecommunications System (UMTS); 

LTE; 

ANSI-C code for the fixed-point Extended Adaptive 

Multi-Rate - Wideband (AMR-WB+) speech codec 

(3GPP TS 26.273 version 11.0.0 Release 11) 



^ 



ibit^lta 



A GLOBAL I M ITI ATI VE 



y 



3GPP TS 26.273 version 1 1 .0.0 Release 1 1 1 ETSI TS 1 26 273 V1 1 .0.0 (201 2-1 0) 



Reference 



RTS/TSGS-0426273vb00 
Keywords 



GSM,LTE,UMTS 



£75/ 

650 Route des Lucioles 
F-06921 Sophia Antipolis Cedex - FRANCE 

Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 

Siret N°348 623 562 00017 - NAF 742 C 
Association a but non lucratif enregistree a la 
Sous-Prefecture de Grasse (06) N° 7803/88 



Important notice 
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pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://ipr.etsi.org) . 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3 GPP and ETSI identities can be found under 
http://webapp.etsi.org/key/queryform. asp . 



ETSI 



3GPP TS 26.273 version 1 1 .0.0 Release 1 1 3 ETSI TS 1 26 273 V1 1 .0.0 (201 2-1 0) 



Contents 



Intellectual Property Rights 2 

Foreword 2 

Foreword 4 

1 Scope 5 

2 References 5 

3 Definitions and abbreviations 5 

3.1 Definitions 5 

3.2 Abbreviations 5 

4 C code structure 6 

4.1 Contents of the C source code 6 

4.2 Program execution 6 

4.3 Code hierarchy 6 

4.5 Variables, constants and tables 19 

4.5.1 Description of fixed tables used in the C-code 19 

4.5.2 Static variables used in the C-code 20 

5 File formats 25 

5.1 Audio file (encoder input/decoder output) 25 

5.2 Parameter bitstream file (encoder output/decoder input) 25 

Annex A (informative): Change history 26 

History 27 



ETSI 



3GPP TS 26.273 version 1 1 .0.0 Release 1 1 4 ETSI TS 1 26 273 V1 1 .0.0 (201 2-1 0) 



Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document contains an electronic copy of the ANSI-C code for the Fixed-point Extended Adaptive 
Multi-Rate Wideband codec. Alternatively, floating-point ANSI-C code is specified in 3GPP TS 26.304 [1]. The 
floating-point codec/encoder/decoder specified in the present document or the floating-point codec/encoder/decoder 
specified in 3GPP TS 26.304 [1] may be used depending on if the implementation platform is better suited for a 
floating-point or a fixed-point implementation. It has been verified that the fixed-point and floating-point codecs 
interoperate with each other without any artifacts. 

The fixed-point ANSI-C code in the present document defines, besides the floating-point c-code specified in 
3GPP TS 26.304 [1], one valid reference implementation of the Extended Adaptive Multi-Rate Wideband transcoder 
(3GPP TS 26.290 [2]). Standard conformance it is enforced by meeting the conformance criteria defined in 
3GPPTS 26.274 [3]. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 26.304: "Extended Adaptive Multi-Rate - Wideband (AMR-WB+) codec; Floating-point 

ANSI-C code". 

[2] 3GPP TS 26.290: "Audio codec processing functions; Extended Adaptive Multi-Rate - Wideband 

(AMR-WB+) codec; Transcoding functions". 

[3] 3GPP TS 26.274: "Speech codec speech processing functions; Extended Adaptive Multi-Rate - 

Wideband (AMR-WB+) speech codec; Conformance testing". 

[4] 3GPP TS 26.244: "Transparent end-to-end packet switched streaming service (PSS); 3GPP file 

format (3GP)". 

3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions are given in 3GPP TS 26.290 [1]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

AMR-WB+ Extended Adaptive Multi-Rate WideBand 

ANSI American National Standards Institute 

ETS European Telecommunication Standard 

GSM Global System for Mobile communications 

I/O Input/Output 

RAM Random Access Memory 
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ROM Read Only Memory 



C code structure 



This clause gives an overview of the structure of the bit-exact C code and provides an overview of the contents and 
organization of the C code attached to the present document. 

The C code has been verified on the following systems: 

IBM PC/AT compatible computers with Windows 2000 SP4 and Microsoft Visual C++ v.6.0 compiler. 

ANSI-C was selected as the programming language because portability was desirable. 

4.1 Contents of the C source code 

The C code distribution has the files divided in six different directories, all present in the directory c-code. The 
directories are: common Jx, decoder Jx, encoder Jx, lib_amr_fx include Jx and basic_op. The distributed files with 
suffix "c" contain the source code and the files with suffix "h" are the header files. 

Project and workspace files are provided in the directory MSVC. 

4.2 Program execution 

The Extended Adaptive Multi-Rate Wideband codec is implemented in two programs: 

- {encoder) audio encoder; 

- {decoder) audio decoder. 
The programs should be called like: 

- encoder [encoder options] -if <audio input file> -of <parameter file>; 

- decoder [decoder options] -if <parameter file> -of <audio output file>. 

The input files contain one or two channels of 16-bit linear encoded PCM audio samples stored in the wav file format 
and the parameter files contain encoded audio data and some additional flags. 

The encoder and decoder options will be explained by running the applications without input arguments. Detailed 
information explaining the use of the AMR-WB+ encoder and decoder programs is provided in the user"s guide in 
Annex A of [1]. See also the file readme.txt for condensed information on how to run the encoder and decoder 
programs. 

4.3 Code hierarchy 

Tables 1 and 2 are call graphs that show the functions used in the audio codec. 

Each column represents a call level and each cell a function. The functions contain calls to the functions in rightwards 
neighbouring cells. The time order in the call graphs is from the top downwards as the processing of a frame advances. 
All standard C functions: printf(), fwrite(), etc. have been omitted. Also, no basic operations (add(), L_add(), mac(), 
etc.) or double precision extended operations (e.g. L_Extract(), Copy() or Set_zero()) appear in the graphs. The 
initialization of the static RAM (i.e. calling the _init functions) is also omitted. 

The basic operations are not counted as extending the depth, therefore the deepest level in this software is level 6. 
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Table 1 : Encoder call structure 



coder_amrwb_ 
plus_stereo 



Scale_speech_st 



Rescale_enc_mem_ 

St 



Decim_12k8_p 



HP50_12k8_p 



Mix ch 



Preemph_scaled 



Rescale_enc_mem_ 

St 



Coder If 



Scale_sig 



Interpol 



AutocorrPlus 



Lag_window_p 



Levinson 



Azjsp 



Intjpc 



Find_wsp 



LP Decim2 



Scale_sig 



scale_mem_Hp_ 
wsp 



Pitch mad ol 



Ispjsf 



Qpisf_2s_46b 



Chebps2 



lsp_Az 



Weight_a 



Residu2 



Deemph 



Hp_wsp 



VQ_stage1 



Sub VQ 



Get_isp_pol 



Dpisf_2s_46b 



Reorder isf 



ETSI 



3GPP TS 26.273 version 11.0.0 Release 11 



ETSI TS 126 273 V1 1.0.0 (2012-10) 



coder_acelp 












Scale_sig 




Residu 




Weight_a 




Synjilt 




Deemph2 




Preemph 




Syn_filt_s 




Pitch_fr4 






Norm_Corr 




Convolve 




lnterpol_4 






Pred_lt4 






Convolve 




G_pitch 




Updtjar 




Pit_shrp 




cor_h_x 




ACELP_4t64_fx 




cor_h_vec 




searchjxiy 




Quant_2p_2N1 




Quant_1p_N1 




Quant_3p_3N1 




Quant_2p_2N1 




Quant_4p_4N 






Quant_4p_4N1 




Quant_2p_2N1 




Quant_5p_5N 








Quant_3p_3N1 




Quant_2p_2N1 




Quant_6p_6N_2 








Quant_5p_5N 




Quant_3p_3N1 




Quant_2p_2N1 


Quant_4p_4N 






Quant_4p_4N1 




Quant_2p_2N1 


Quant_3p_3N1 






Quant_2p_2N1 




Quant_2p_2N1 
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Scale_speech 



Rescale_enc_mem_ 
hf 



coder hf 



Segsnr 



Coder tcx 



Q_gain2_plus 



Cos window 



Weight_a 



Residu2 



Deemph 



fft9 fx 



FFT reorder 



Adap_low_freq_e 
mph 



AVQ Cod 



Scale tcx ifft 



Adap_low_freq_d 
eemph 



Ifft reorder 



ifft9 fx 



Get_gain 



Q_gain_tcx 



Preemph 



Scale_sig 



Syn_filt_s 



init r fft fx 



r fft fx 



SpPeak1k6 



RES PPV FX 



Scale_sig 



SpPeak1k6 



Deemph1k6 



r fft fx 



AutocorrPlus 



Lag_window_p 



Levinson_p 
Az_isp_p 



Chebps2 



Quant_1p_N1 



Nearest_neighbor 
2D8 
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Intjpc 






lsp_Az 




Get_isp_pol 


Ispjsf 






Q_isf_hf 




Sub_VQ 




Reorderjsf 




Isfjsp 






Match_gain_6k4 




Residu 




Synjilt 




Scale_sig 




lnt_gain 






Residu2 




Syn_filt_s 




E LPC a weigh 

t 




Weight_a 




Q_gain_hf 




Band split taligned 
_2k 








Decim_2k 








lnterpol_st 




Oversamp_2k 








lnterpol_st 




Coder_stereo_x 








Cod_hi_stereo 






Residu2 




Compute_exc_sid 

6 




Compute_cross_c 
orr vector 




Cholsolc 




Cholsolc_repair 




Smooth_ener_filte 
r 
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quantjilt 






Pmsvq2 






Msvq2 




M_cbcod 


Firjilt 




Compute_gain_m 
atch 




Quant_gain 




Cod_tcx_stereo 






Ctcx_stereo 








Cos_window 




Windowing 




Comp gain shap c 
od 




Apply_gain_shap 




Get_gain 




Q_gain_pan 




Compute_xn_target 




Fft3 






rjftjx 




FFT_reorder 






Adap low freq em 
Ph 


SpPeak1k6 




AVQ_Cod 






RE8_PPV_FX 




Nearest neighb 
or 2D8 


Scale_tcx_ifft 






Scale_sig 




Adap_low_freq_dee 
mph 






SpPeak1k6 




Deemph1k6 




lfft_reorder 






IfftS 


rJftJx 




Q_gain_tcx 






Apply_tcx_overlap 




Segsnr 
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Int2bin 
















Enc_prm 




Int2bin 




AVQ_encmux 




split_idx_noovf 




sort(avq_cod.c) 
RE8_cod 




RE8_vor 




Re8_identify_ab 
solute 


Leader 




Re8_ooord 






Re8_k2y 




RE8_PPV_FX 




Nearest 
r 2D8 


_neighbo 


Re8_compute_ba 
sejndex 










Re8_oompute_r 
ank_of_permutat 
ion and s 






calc_bits 










writ_all_nq 








calc_bits 




writ_all_i 






init_pos_i_ovf 




chk_ovf 




chk_ovf 






writ_l 




writ_k 




writ_ovf 




Unpack4bits 








Int2bin 




Enc_prm_stereo_x 








Iint2bin 




AVQ_encmux 




split_idx_noovf 




sort(avq_cod.c) 




RE8_cod 




RE8_vor 




re8_identify_abs 
olute 


Leader 




re8_coord 
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Enc_prm_hf 



unpack4bits_d 



writ_all_nq 



writ all I 



int2bin 



int2bin 



calc bits 



calc bits 



init_pos_i_ovf 



chk ovf 



writ I 



writ ovf 



writ k 




re8_compute_bas 
e index 



RES PPV FX 



nearest_neighbo 
r 2D8 



re8_compute_ra 
nk_of_permutati 
on and s 



chk ovf 
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Table 2: Decoder call structure 



Decoder_amrwb_p 
lus 



Bin2int 



Dec_prm 



Dec_prm_stereo_x 



Dec_prm_hf 



Decoder_amrwb_p 
lus 1 



Bin2int 



Pack4bits 



Bin2int 



Bin2int 



Pack4bits d 



AVQ Demuxdec 



Bin2int 



Decoder If 



Bin2int 



Read_all_nq 



Read all I 



RES Dec 



Read_nq 



lnit_pos_i_ovf 



Split_n 



Chk ovf 



Read I 



Read ovf 



Read k 



Chk ovf 



Re8_decode_ba 
se index 



Re8_k2y 



Re8_decode_rank 
_of_permutation 



RE8 PPV FX 



Nearest_neighbor_ 
2D8 



Dpisf_2s_46b_2 



Isfjsp 



Intjpc 



decoder tcx 



Reorder isf 



lsp_Az 



Get_isp_pol 
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Decoder_acelp 



AVQ Demuxdec 



Scale tcx ifft 



NoiseFill 



Adap_low_freq_ 
deemph 



Find_mpitch 



Ifft reorder 



ifft9 fx 



Cos window 



D_gain_tcx 



Scale mem tcx 



Preemph 



Weight_a 



Syn_filt_s 



Residu2 



Read_all_nq 



Read all I 



RES dec 



Read_nq 



lnit_pos_i_ovf 



Split_n 



Chk ovf 



Read I 



Read k 



Read ovf 



Chk ovf 



Re8_decode_base 
index 



Re8_k2y 



Re8_decode_rank 
_of_permutation 



RE8 PPV FX 



Nearest_neighbor_ 
2D8 



Scale_sig 



Rnd_ph16 



Random 



SpPeak1k6 



Deemph1k6 



r fft fx 



Scale_sig 



Pred It4 



DEC_ACELP_4t 
64 fx 
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Dec 1p N1 




Dec_1p_N1 

Dec_2p_2N1 
Dec_1p_N1 

Dec_2p_2N1 
Dec_1p_N1 


Dec_2p_2N1 




Dec_3p_3N1 






Dec 2p 2N1 




Dec_1p_N1 


Dec 4p 4N 






Dec_4p_4N1 








Dec 1p N1 




Dec_2p_2N1 




Dec 3p 3N1 










Dec 5p 5N 






Dec_2p_2N1 




Dec 3p 3N1 










Dec_6p_6N_2 




Dec 1p N1 




Dec 2p 2N1 
Dec_3p_3N1 






Dec_2p_2N1 




Dec_1p_N1 


Dec_4p_4N 




Dec 4p 4N1 










Dec_5p_5N 








Dec 2p 2N1 






Dec_3p_3N1 














add_pulses 




Preemph 






Pit_shrp 




D gain2 plus 




Scale exc 






Scale_sig 


Scale sig 




voice factor 




Rescale mem 






Scale_sig 


Syn_filt_s 




Weight a 




Residu 





Dec_1p_N1 



Dec_2p_2N1 
Dec_1p_N1 
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Deemph2 




Updt_mem_q 




Scale mem2 








Scale sig 




Deemph 






Bass_postfilter 




Scale_sig 




Short_pitch_tracker 




Decoder_hf 






D_isf_hf 






Reorder isf 


Isfjsp 




Intjpc 


lsp_Az 






Get_isp_pol 


Match_gain_6k4 






Residu 




Synjilt 




Scale sig 




Int gain 






D gain chan 




D gain hf 




Soft exc hf 




Syn filt s 




Smooth ener hf 




Delay 






Oversamp_12k8 




Interpol 




Decoder_stereo_x 




Decim 2k 




Band split taligne 
d 2k 










InterpoLst 


Dec_tcx_stereo 


Oversamp 2k 




Dtcx_stereo 


InterpoLst 












Cos_window 
Scale tcx ifft 










Scale_sig 


Windowing 
Comp_gain_sha 

P 

adap_lo_freq_de 

emph 
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Dec_hi_stereo 

Delay 
BandJoin_2k 


Get_alpha 
Ch_sep 

Decjilt 

Dec_gain 

Residu 




Ifft reorder 
IfftS 

Balance 

D_gainjcx 

Apply xnq gain 

2 

Apply_wienjilt 

Crosscorr_2 

Glev_s 

ApplyJcx_overl 

ap 


SpPeak1k6 




Deemph1k6 








ifft_rel 








D Balance 


















































Firjilt 

Get_exc_win 
Get_exc 
Synjilt_s 


























InterpoLst 






HP50 12k8 






Oversamp_12k8 






Interpol 
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4.5 Variables, constants and tables 

The data types of variables and tables used in the fixed point implementation are signed integers in 2's complement 
representation, defined by: 

- Wordl6 16 bit variable; 

- Word32 32 bit variable. 

4.5.1 Description of fixed tables used in the C-code 

This clause contains a listing of all fixed tables sorted by source file name and table name. All table data is declared as 
Wordl6. 

Table 3: Encoder fixed tables 



Format 


Table name 


Size 


Description 


Format 


Word16 


MonoRate 


54 


Predefined mono rate 


Q6/Q0/Q0 


Word16 


StereoRate 


81 


Predefined stereo rate 


Q6/Q0/Q0 


Word16 


NBITS_CORE_AMR_WB_FX 


9 
miMo 
de fx 


AMR WB Core bits 


QO 


Word 16 


miMode fx 


48 


Stereo Mode Index 


QO 


Word 16 


isflndex fx 


14 


Internal sampling Frequency 


QO 


Word 16 


NBITS CORE FX 


8 


Core bit-rates 


QO 


Word 16 


t sinFxS4 


1440 


FFT Sine&Cos table 


013 


Word 16 


Filter 32k 


61 


FIR table for decimation/oversampling 


013 


Word 16 


Filter 32k hf 


61 


FIR table for decimation/oversampling 


013 


Word 16 


Filter 32k 7k 


61 


FIR table for decimation/oversampling 


013 


Word 16 


Filter 48k 


185 


FIR table for decimation/oversampling 


013 


Word 16 


Filter 48k hf 


185 


FIR table for decimation/oversampling 


013 


Word 16 


Filter 8k 


61 


FIR table for decimation/oversampling 


013 


Word 16 


Isf init 


16 


Initial ISF memory 




Word 16 


Isp init 


16 


Initial ISP memory 


015 


Word 16 


Isp init HF 


8 


HF Initial ISP memory 


015 


Word 16 


Mean isf 


16 


Means of ISFs 




Word 16 


Dicoljsf 


2304 


1 ^* stage codebook, isfO to isf8 




Word 16 


Dico2_isf 


1792 


1^* stage codebook, isf9 to isf 15 




Word 16 


Dico21_isf 


192 


2"d stage codebook, isf2 to isf 2 2 




Word 16 


Dico22_isf 


384 


2"d stage codebook, isf2 3 to isf 2 5 




Word 16 


Dico23_isf 


384 


2"d stage codebook, isf2 6 to isf 2 8 




Word 16 


Dico24_isf 


96 


2"d stage codebook, isf2 9 to isf 2 11 




Word 16 


Dico25 isf 


128 


2"d stage codebook, isf2 1 2 to isf 2 15 




Word 16 


Dico21_isf_36b 


640 


1^^ stage codebook, (36b) split 1 




Word 16 


Dico22_isf_36b 


512 


1^^ stage codebook, (36b) split 2 




Word 16 


Dico23_isf_36b 


448 


1^^ stage codebook, (36b) split 3 




Word 16 


Dico gain hf 


512 


Quantization table for one-stage HF gain 


08 


Word 16 


Mean isf hf 12k8 


8 


Means of ISFs (full band) 




Word 16 


Dicol isf hf 12k8 


32 


1^* stage isf codebook (full band) 




Word 16 


Mean isf hf low rate 


8 


Means of isfs 




Word 16 


Dicol isf hf low rate 


32 


1 ^* stage isf codebook 




Word 16 


Dico2 isf hf 


1024 


2"^ stage isf codebook 




Word 16 


Filt Ip 


13 


Low-pass fir filter for bass post filter 


015 


Word 16 


Sin20 


20 


Random phase 


015 


Word 16 


Inter4 2 


128 


1/4 resolution interpolation filter 


014 


Word 16 


VadFiltBandFreqs 


12 


Open-loop classifier 


OO 


Word 16 


Bw inv 


12 


Open-loop classifier 


022 


Word 16 


Lwg 


8 


Open-loop claissifier 


015 


Word 16 


Gain hf ramp 


64 


HF gain ramp for wb->wb+ switiching 


015 


Word 16 


Inter2 coef 


12 


Filter coefficients for band join/split 


013 


Word 16 


Filter LP180 


2341 


Filter for 48 kHz interpolation 


014 


Word 16 


StereoNbits FX 


18 


Stereo bit-rates 


OO 
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Format 


Table name 


Size 


Description 


Format 


Word16 


Filter 2k fxQ14 32 


321 


2k decimation filter 


Q14 


Word16 


Filter 2k fxQ14 5 


321 


2k decimation filter 


Q14 


Word16 


cb filt hi mean fx 


9 


Average filter 


Q14 


Word 16 


Filt hi mscb 4a fx 


16*9 




Q14 


Word 16 


Filt hi mscb 7a fx 


16*9 




Q14 


Word 16 


Filt hi mscb 7b fx 


8*9 




Q14 


Word 16 


Cb gain hi mean fx 


2 


Average gain vector 


Q10 


Word 16 


Gain hi mscb 2a fx 


4*2 




Q10 


Word 16 


Gain hi mscb 5a fx 


32*2 




Q10 


Word 16 


Dico1_isf_hf_high_rate 


32 


1 ^^ stage isf codebook 




Word 16 


Mean isf hf high rate 


8 


Means of isfs 




Word 16 


Filter LP45 


586 


Filter for 48 kHz interpolation 


Q14 


Word 16 


t_qua_gain6b 


128 


Gain pitch and gain code 


Q14/Q11 


Word 16 








Q14/Q11 


t qua gai 


t_qua_gain7b 


256 


Gain pitch and gain code 




n7b 










Word 16 


Overlap_wind 


63 


Overlap window 


Q15 


Word 16 


Cos wind 


128 


Cos window 


Q15 


Word 16 


Cos wind LR 


224 


Cos _window (Low rate) 


Q15 


Word 16 


TXV 


31 


Arctan piece table 


Q15 


Word 16 


Len tbi 


6 


Inverse length 


Q15 


Word 16 


interpol_frac4 


4 


Interpolation Window 4 sub-frame 


Q15 


Word 16 


interpol_frac8 


8 


Interpolation Window 8 sub-frame 


Q15 


Word 16 


interpol_frac16 


16 


Interpolation Window 16 sub-frame 


Q15 


Word 16 


size_filt_hi_msvq_4_fx 


16 


Stereo param 




Word 16 


*cbs_filt_hi_msvq_4_fx 


16 


Stereo param 




PMSQ fx 


filt_hi_pmsvq4_fx 








Word 16 


size_filt_hi_msvq_7_fx 


16 


Stereo param 




Word 16 


*cbs_filt_hi_msvq_7_fx 


16 


Stereo param 




PMSQ fx 


filt_hi_pmsvq7_fx 








Word 16 


Size gain hi msvq 2 fx 


16 


Stereo param 




Word 16 


*cbs gain hi msvq 2 fx 


16 


Stereo param 




PMSQ fx 


gain_hi_pmsvq2_fx 








Word 16 


size gain hi msvq 5 fx 


16 


Stereo param 




Word 16 


*cbs gain hi msvq 5 fx 


16 


Stereo param 




PMSQ fx 


gain hi pmsvq5 fx 









Table 4: Decoder fixed tables 



Format | Table name | Size | Description 



Same as encoder 



4.5.2 Static variables used in the C-code 

In this clause two tables that specify the static variables for the encoder and decoder respectively are shown. All static 
variables are declared within a C struct. 
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Table 6: Encoder static variables 



Struct name 


Type 


Variable 


Type[Length] 


Description 


Coder_StState_fx 










Word16 


mem decim 


1608 


speech decimated filter memory 


Word 16 


decim frac 


1 


Fractional decimation factor 


Word 16 


mem sig in 


6 


hp filter memory 


Word 16 


mem_preemph 


1 


speech preemphasis filter mem 


Word 16 


mem decim hf 


46 


HF filter memory 


Word 16 


old speech hf 


528 


HF old speech vector 


Word 16 


past q isf hf 


8 


HF past quantized isf 


Word 16 


ispold hf 


8 


HF old isp 


Word 16 


ispold q hf 


8 


HF quantized old isp 


Word 16 


old gain; 


1 


HF old gain match 


Word 16 


mem hfl 


8 


HF memory for gain 1 


Word 16 


mem hf2 


8 


HF memory for gain 2 


Word 16 


mem hf3 


8 


HF memory for gain 3 


Word 16 


old exc 


375 


old excitation 


Word 16 


Q sp hf 


1 


Scaling hf speech 


Word 16 


OldQ sp hf 


2 


old scaling hf speech 


Word 16* 


mean isf hf 


1 


isf codebook mean 


Word 16* 


dicol isf hf 


1 


isf codebook first stage 


Coder_State_Plus_fx 










Coder StState fx 


Left 


2617 


state for left channel 


Coder StState fx 


Right 


2617 


state for right channel 


Word 16 


old Chan 


528 


old left signal 


Word 16 


old Chan 2k 


140 


old left signal 2 kHz sampl. rate 


Word 16 


old Chan hi 


448 


old left signal HB 


Word 16 


old speech 2k 


140 


old mono signal 2 kHz sampl. rate 


Word 16 


old speech hi 


448 


old mono signal HB 


Word 16 


old_speech_pe 


528 


past pre-emphasised mono 


Word 16 


old wh 


9 


past weighted filter 


Word 16 


old_wh_q 


9 


past quantized weighted filter 


Word 16 


old gm gain 


2 


past gain matching 


Word 16 


old exc mono 


9 


past mono excitation 


Word 16 


filt_energy_thre 
shold 


1 


filter energy thershold 


Word 16 


w window 


64 


weighting window 


PMSVQ fx* 


*filt hi pmsvq 


1 


MSVQ quantizer 


PMSVQ fx* 


*gain hi pmsvq 


1 


MSVQ quantizer 


Word 16 


mem_stereo_ov 
lp_size 


1 


past stereo overlap size 


Word 16 


mem stereo ov 
Ip 


32 


past stereo overlap 


NCLASSDATA 


*stClass 


1 


use case B classifier 


VadVars 


*vadSt 


1 


VAD state 


Word 16 


vad hist 


1 


VAD history 


Word 16 


old speech 


528 


old speech 


Word 16 


old synth 


16 


synthesis memory 


Word 16 


past isfq 


16 


past isf quantizer 


Word 16 


old wovlp 


128 


last tcx overlap 


Word 16 


old d wsp 


187 


Weighted speech vector 


Word 16 


old exc 


392 


old excitation vector 


Word 16 


old_mem_wsyn 


1 


weighted synthesis memory 


Word 16 


old mem wO 


1 


weighted speech memory 


Word 16 


old mem xnq 


1 


quantized target memory 


Word 16 


old ovip size 


1 


last tcx overlap size 


Word 16 


Isfold 


16 


old isf frequency domain 


Word 16 


Ispold 


16 


old isp 


Word 16 


ispold q 


16 


quantized old isp 


Word 16 


mem_wsp 


1 


wsp vector mem 


Word 16 


mem Ip decim 
2 


3 


wsp decimator filter mem 
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Struct name 


Type 


Variable 


Type[Length] 


Description 




Word16 


ada w 


1 


open loop LTP 


Word 16 


ol gain 


1 


open loop LTP 


Word 16 


ol_wght_flg 


1 


open loop LTP 


Word 16 


old ol lag 


5 


past openloop lag 


Word 16 


old TO med 


1 


past pitch 


Word 16 


hp old wsp 


699 


past HP weighted speech 


Word 16 


hp ol Itp mem 


9 


past HP openloop long term prediction 


Word 16 


window 


512 


LP analysis window 


Word 16 


SwitchFlagPlus 
ToWB 


1 


flag for switching to AMR-WB 


Word 16 


mem_gain_cod 
e 


4 


past code gain 


Word 16 


prev mod 


1 


past frame type 


Word 16 


Q sp 


1 


Scaling of speech 


Word 16 


OldQ sp 


1 


Old scaling of speech 


Word 16 


i offset 


1 




Word 16 


pit max 


1 


Mem of pit max 


Word 16 


lev mem 


18 


Levinson durbin memory 


Word 16 


old_wsp_max 


4 


Weight speech scaling memory 


Word 16 


old_wsp_shift 


1 


limit dynamic at 12 bits 


Word 16 


scale fac 


1 


scaling factor (preemph speech) 


Word 16 


Q new 


1 


scaling factor of speech 


Word 16 


Q max 


2 


Q new limitation 


Word 16 


OldQ sp deci 


2 


Q new memory 


Word 16 


Q exc 


1 


excitation scaling 


Word 16 


Old Qexc 


1 


excitation scaling memory 


Word 16 


LastQMode 


1 


Last subfr mode (acelp/tcx) 


Encoder Config 










Word 16 


mode 


1 


AMR WBcore mode: 0..8 


Word 16 


extension 


1 


0=AMRWB, 1=WB+ 


Word 16 


St mode 


1 


stereo mode 


Word 16 


fscale 


1 


frequency scaling 


Word 16 


use_case_mod 
e 


1 


use case (for AMRWB+ only) 


Word 16 


allow dtx 


1 


dtx (for AMRWB only) 


Word 16 


FileFormat 


1 


3gp or raw 


Word 16 


mode index 


1 


index of wb+ mode used 


Word 16 


fscale index 


1 


index of internal frequency sampling 


Word 16 


be 


1 


Backward compatible file format 
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Table 7: Decoder static variables 



Struct name 


Type 


Variable 


Type[Length] 


Description 


Decoder_StState 










Word 16 


wmem oversamp 


72 


Memory oversampling 


Word 16 


wover frac 


1 


Fractional overcloking factor 


Word 16 


wmem oversamp 
hf 


24 


memory 


Word 16 


wpast_q_isf_hf 


8 


HF past quantized isf 


Word 16 


wpast_q_isf_hf_ot 
her 


8 


HF past quantized isf for the other 
channel when mono decoding stereo 


Word 16 


wpast q gain hf 


1 


HF past quantized gain 


Word 16 


wpast_q_gain_hf_ 
other 


1 


HF past quantized gain for the other 
channel when mono decoding stereo 


Word 16 


wold gain 


1 


HF old gain match 


Word 16 


wispold_hf 


8 


HF old isp 


Word32 


Lthreshold; 


1 


HF memory for smooth ener 


Word 16 


wmem syn hf 


8 


HF synthesis memory 


Word 16 


mem d tcx fx 


96 


delay compensation memory 


Word 16 


wmem d none 


64 


Non causality delay 


Word 16 


mem_synth_hi 


16 


High band sunthesis memory 


Word 16 


wmem sig out 


6 


hp filter memory 


Word 16 


wold synth hf 


512 


synch delay memory 


Word32 


Lp_amp 


1 


memory for soft exc 


Word 16* 


mean isf hf 


1 


isf codebook mean 


Word 16* 


dicol isf hf 


1 


isf codebook first stage 


Word 16 


Q synHF 


1 


scaling of hf synth 


Decoder State 
Plus 










Decoder StState 


left 


833 


State for left channel 


Decoder StState 


right 


833 


State for right channel 


Word 16 


mem left 2k fx 


20 


2kHz memory on left chan 


Word 16 


mem right 2k fx 


20 


2kHz memory on right chan 


Word 16 


mem left hi fx 


64 


HB memory left channel 


Word 16 


mem right hi fx 


64 


HB memory right channel 


Word 16 


my old synth 2k 
fx 


35 


old 2kHz synthesis 


Word 16 


my_old_synth_hi_f 

X 


128 


old HB synthesis 


Word 16 


my old synth fx 


148 


old stereo synth 


Word 16 


old_AqLF_fx 


85 


old quantized LPC 


Word 16 


old wh fx 


9 


old decoded filter 


Word 16 


old wh2 fx 


9 


old decoded filter 2 


Word 16 


old exc mono fx 


9 


old mono excitation 


Word 16 


old gain left fx 


4 


old gain on left chan 


Word 16 


old gain right fx 


4 


old gain on right chan 


Word 16 


old wh q fx 


9 


past quantized filter 


Word 16 


old gm gain fx 


2 


past gain matching 


Word 16 


W window 


64 


weighted synthesis window 


PMSVQ 


*filt hi pmsvq fx 


1 


past MSVQ filter 


PMSVQ 


*gain hi pmsvq fx 


1 


past MSVQ gain 


Word 16 


mem_stereo_ovlp_ 
size fx 


1 


past stereo overlap size 


Word 16 


mem stereo ovip 
fx 


32 


past stereo overlap 


Word 16 


last stereo mode 


1 


past stereo mode 


Word 16 


side rms fx 


1 


side signal RMS 


Word 16 


H fx 


9 


current filter 


Word 16 


wold xri 


1 148 


old spectral coefficeints 


Word 16 


last mode 


1 


last mode in previous 80ms frame 


Word 16 


wmem sig out 


6 


hp50 filter memory for synthesis 


Word 16 


wmem deemph 


1 


speech deemph filter memory 


Word 16 


prev Ipc lost 


1 


previous Ipc is lost when = 1 


Word 16 


wold synth 


16 


synthesis memory 


Word 16 


wold exc 


392 


old excitation vector 


Word 16 


wisfold 


16 


old isf (frequency domain) 
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Struct name 


Type 


Variable 


Type[Length] 


Description 




Word16 


wispold 


16 


old isp (immittance spectral pairs) 


Word 16 


wpastjsfq 


16 


past isf quantizer 


Word 16 


wovlp 


128 


last weighted synthesis for overlap 


Word 16 


ovlp_size 


1 


overlap size 


Word 16 


wisf buf 


51 


old isf (for frame recovery) 


Word 16 


wold TO 


1 


old pitch value (for frame recovery) 


Word 16 


wold TO frac 


1 


old pitch value (for frame recovery) 


Word 16 


seed ace 


1 


seed memory (for random function) 


Word 16 


wmem_wsyn 


1 


TCX synthesis memory 


Word 16 


seed tcx 


1 


seed memory (for random function) 


Word 16 


wwsyn rms 


1 


rms value of weighted synthesis 


Word 16 


wpast gpit 


1 


past gain of pitch (for frame recovery) 


Word32 


Lpast gcode 


1 


past gain of code (for frame recovery) 


Word 16 


pitch_tcx 


1 


for bfi 


Word32 


L go threshold 


1 


GC threshold 


Word 16 


wold synth pf 


503 


Bass post-filter: old synthesis 


Word 16 


wold_noise_pf 


24 


bass post-filter: noise memory 


Word 16 


wold T pf 


2 


bass post-filter: old pitch 


Word 16 


wold gain pf 


2 


Bass post-filter: old pitch gain 


Word 16 


*mean isf hf 




HF isf codebook in-use 


Word 16 


*dico1 isf hf 




HF isf codebook in-use 


Word 16 


wmem gain code 


4 


past code gain 


Word 16 


wmem Ipc hf 


9 


past HF Ipc filter 


Word 16 


wmem gain hf 




past HFgain 


Word 16 


wramp state 




ramp state 


Word 16 


cp old synth 


16 


old synthesis switching memory 


Word 16 


Q old 




Old scaling 


Word 16 


Q exc 




excitation scaling 


Word 16 


Q syn 




synthesis scaling 


Word 16 


Old Q syn 




Old synthesis scaling 


Word 16 


Old Q exc 




Old excitation scaling 


Word 16 


prev Q syn 




Limitation on synthesis scaling 


Word 16 


mem syn2 


16 


Switching synthesis memory 


Word 16 


Old Qxnq 




Old xnq scaling 


Word 16 


Old QxnqMax 




Old maximum xnq scaling 


Word 16 


Old Qxri 




Old xri scaling 


Word 16 


Old bpf scale 




noise buf scaling 


Word 16 


mem subfr q 


7 


subfr maximum excitation scaling 


Word 16 


old subfr q 


16 


subfr true excitation scaling 


Word 16 


old syn q 


16 


subfr true synthesis scaling 


Word 16 


i offset 




offset memory 


DecoderConfig 










Word 16 


mode 




AMR WB core modes 


Word 16 


extension 




= AMR WB1 =WB+ 


Word 16 


St mode 




Stereo modes 


Word 16 


fscale 




Internal Frequency scaling 


Word32 


fs 




Sampling rate 


Word32 


mono dec stereo 




decode mono a stereo bitstream 


Word32 


limiter on 




Limite clipping 


Word 16 


Fileformat 




File format used (raw/3gp) 


Word 16 


fer Sim 




Frame erasure simulation 
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5 File formats 

This clause describes the file formats used by the encoder and decoder programs. 

5.1 Audio file (encoder input/decoder output) 

Audio files read by the encoder must be formatted as 16 bits PCM wave (*.wav) files. The decoder output is written as 
a 16 bit PCM wave file (*.wav). 

Note that the decoder, with proper command line switch, can produce a mono file from a stereo bit-stream. 

5.2 Parameter bitstream file (encoder output/decoder input) 

For AMR-WB+ operation, the files produced by the audio encoder/expected by the audio decoder are either according 
to the raw format defined in 3GPP TS 26.290 [2], clause 8.2, or according to the 3GP file format (3GPP TS 26.244 [4]), 
whereby the storage sample definition is found in 3GPP TS 26.290 [2], clause 8.3. 
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Annex A (informative): 
Change history 



Change history 


Date 


TSG SA# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Old 


New 


2005-03 


27 


SP-050083 






Approved at TSG SA#27 Plenary 


2.0.0 


6.0.0 


2005-06 


28 


SP-050252 


001 




Prevent an access outside a buffer when simulating 
frame erasures 


6.0.0 


6.1.0 


2005-06 


28 


SP-050252 


002 


1 


Remove unused code 


6.0.0 


6.1.0 


2005-06 


28 


SP-050252 


003 




Remove IF2 header in AMR-WB bitstream 


6.0.0 


6.1.0 


2005-06 


28 


SP-050252 


004 




Prevent an access outside a buffer in 
Reconst spect function 


6.0.0 


6.1.0 


2005-06 


28 


SP-050252 


005 




Decoder synchronization after frame erasures 


6.0.0 


6.1.0 


2005-06 


28 


SP-050252 


006 




Correction of mode switching using configuration file 


6.0.0 


6.1.0 


2005-06 


28 


SP-050252 


007 




Prevent encoding end of wave file information 


6.0.0 


6.1.0 


2005-06 


28 


SP-050252 


008 




Correction of library function for 3GP file format 


6.0.0 


6.1.0 


2005-06 


28 


SP-050252 


009 




Support for input files with sampling frequency other 
than 48 kHz 


6.0.0 


6.1.0 


2005-09 


29 


SP-050425 


0010 




Correction to frame erasure concealment 


6.1.0 


6.2.0 


2005-09 


29 


SP-050425 


0011 




Correction to threshold value in bandwidth 
extension 


6.1.0 


6.2.0 


2005-09 


29 


SP-050425 


0012 




Removal of copyright statements and unused files 


6.1.0 


6.2.0 


2005-12 


30 


SP-050785 


0013 




Correction to scaling of decimation filter memory 


6.2.0 


6.3.0 


2006-03 


31 


SP-060012 


0014 




Correction to end-of-file logic and initialisation in 
AMR-WB modes 


6.3.0 


6.4.0 


2006-03 


31 


SP-060012 


0015 




Correction to unnecessary look ahead in encoder 


6.3.0 


6.4.0 


2006-03 


31 


SP-060012 


0016 




Correction to memory initialization and memory 
overwrite when switching between AMR-WB and 
AMR-WB+ modes 


6.3.0 


6.4.0 


2006-06 


32 


SP-060353 


0017 




Correction to switching between AMR-WB and 
AMR-WB+ modes 


6.4.0 


6.5.0 


2006-06 


32 


SP-060353 


0018 




Correction to default stereo codec configurations 


6.4.0 


6.5.0 


2007-03 


35 


SP-070029 


0019 




Reference to users guide 


6.5.0 


7.0.0 


2008-12 


42 








Version for Release 8 


7.0.0 


8.0.0 


2009-12 


46 








Version for Release 9 


8.0.0 


9.0.0 


2011-03 


51 








Version for Release 10 


9.0.0 


10.0.0 


2012-09 


57 








Version for Release 1 1 


10.0.0 


11.0.0 
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